home *** CD-ROM | disk | FTP | other *** search
/ Best of www.BestZips.com (Collector's Edition) / Best of WWW.BESTZIPS.COM Collector's Edition (JCSM Shareware) (JCS Marketing).ISO / prgtools / vds21016.zip / readme.txt < prev    next >
Text File  |  1997-01-16  |  15KB  |  332 lines
  1. VISUAL DIALOGSCRIPT 2.10 RELEASE NOTES                    16th January 1997
  2. ===========================================================================
  3.  
  4. Welcome to Visual DialogScript!
  5. -------------------------------
  6.  
  7. Thank you for trying Visual DialogScript, the simple program development
  8. tool for Microsoft Windows. Please take a few moments to read this file.
  9. It contains important information both for new users and upgraders from
  10. earlier versions of the product.
  11.  
  12. What is Visual DialogScript?
  13. ----------------------------
  14.  
  15. Visual DialogScript is a programming language and development environment
  16. that has been designed to enable you quickly to develop simple dialog-based
  17. programs or batch files for Windows 95 with the same ease as you might have
  18. written a batch file or a Basic program for DOS.
  19.  
  20. The DialogScript language is easy to learn and similar to, though much more
  21. powerful than, a batch language or macro language. Visual DialogScript also
  22. includes visual tools: a Dialog Editor for designing dialog boxes visually,
  23. and an Icon Editor for creating graphical icons for your programs.  There
  24. is also a Dialog Wizard which generates the code automatically from your
  25. visually designed dialog. Many useful DialogScript programs can be written
  26. in a matter of minutes!
  27.  
  28. If you are new to Visual DialogScript, try the short Tutorial, then take a
  29. few minutes to read through the User Guide section of the online manual.
  30. This explains how the program works and covers basic concepts of the
  31. DialogScript programming language. There are also several examples which
  32. you can try out by cutting the code from the help file, pasting it into the
  33. editor window, and running it.
  34.  
  35. System Requirements
  36. -------------------
  37.  
  38. Visual DialogScript 16-bit requires the following minimum system
  39. specification:
  40.  
  41.     - a 386SX PC with 4Mb RAM, VGA display and mouse;
  42.     - Windows 3.1.
  43.  
  44. Visual DialogScript 32-bit requires the following minimum system
  45. specification:
  46.  
  47.     - a 486 PC with 8Mb RAM, VGA display and mouse;
  48.     - Windows 95.
  49.  
  50. The same specifications apply to programs created with Visual
  51. DialogScript.
  52.  
  53. Note that the 32-bit version uses functions of the Windows 95 shell so
  54. it will not run satisfactorily under Windows NT 3.x.
  55.  
  56. Installation
  57. ------------
  58.  
  59. If you haven't already done so, run the program SETUP.EXE, which will
  60. copy the program files to the desired directory and create an entry
  61. in Program Manager or the Windows 95 Start Menu for the Visual DialogScript
  62. development environment.
  63.  
  64. You may want to move the runtime engine (DSRUN.EXE/DSRUN16.EXE) to the
  65. Windows System directory, or alternatively to add the location of your
  66. Visual DialogScript directory to your PATH statement. If you run
  67. non-integrated DialogScript executables from directories other than the one
  68. in which the runtime engine is located you will get the error message
  69. "Cannot run script" unless this is done.
  70.  
  71. Removing Visual DialogScript from your system
  72. ---------------------------------------------
  73.  
  74. Visual DialogScript adds files to no other directories than its own.  To
  75. remove it, simply delete all the files in the Visual DialogScript directory
  76. and then remove the directory.
  77.  
  78. The 32-bit version creates Registry entries under the Registry key
  79. HKEY_CURRENT_USER\Software\JMTech\DialogScript\2.0.
  80.  
  81. Registering Visual DialogScript
  82. -------------------------------
  83.  
  84. We hope you like Visual DialogScript and find it useful.  However, please
  85. be aware that Visual DialogScript is not free or public domain software.
  86. You are granted a licence giving limited rights to use the software.  The
  87. conditions of use are described in the Licence Agreement in the online
  88. help.
  89.  
  90. This version of Visual DialogScript is fully functional.  However, while it
  91. remains unregistered the software will display its startup screen for a
  92. longer interval, displaying a gentle reminder that the software is still
  93. unregistered.  Also, any EXE programs you create will upon termination
  94. display a message that they were created using an unregistered copy of the
  95. product.
  96.  
  97. Details of how to register, and what it will cost, will also be found
  98. in the online help.
  99.  
  100. Technical support
  101. -----------------
  102.  
  103. Free technical support is available by Internet email, only to registered
  104. users.  However, we will endeavour to answer any questions that may
  105. arise during your evaluation of the product.
  106.  
  107. Support is provided via Internet email at: support@jm-tech.com.
  108.  
  109. Please note that the free support does not extend to writing complete
  110. scripts.  We will be happy to quote for this service at our normal
  111. consultancy rates.
  112.  
  113. Multi-platform support
  114. ----------------------
  115.  
  116. The 32-bit version of Visual DialogScript can create both 32-bit and 16-bit
  117. executable files. DialogScript executables require the appropriate runtime
  118. engine DSRUN.EXE (32-bit) or DSRUN16.EXE (16-bit) or must be created as
  119. integrated executables with a copy of the runtime bound in. Either runtime
  120. is freely redistributable, without royalties, by registered users of the
  121. product.
  122.  
  123. The 16-bit runtime is not included in the 32-bit package, so you will not
  124. be able to run any 16-bit programs that you create with it. To obtain it we
  125. recommend that you download it from our World Wide Web site to ensure you
  126. have the latest version.
  127.  
  128. A common help file is used for both versions. Differences in capabilities
  129. between the two versions are (in general) highlighted where appropriate.
  130.  
  131. Note that the examples in the help file are for the 32-bit version. Most
  132. of the commands where they access the Registry will have to be converted
  133. to the corresponding INI file commands. This is normally a simple matter
  134. of substituting INIFILE for REGISTRY and @iniread for @regread, and
  135. deleting the default key. For other differences see below.
  136.  
  137. 16-bit limitations
  138. ------------------
  139.  
  140. The main points to be aware of when writing 16-bit script programs are:
  141.  
  142. * Long filenames, and various options relating to them, are not supported.
  143.  
  144. * Registry support is limited, and does not allow named values to be used.
  145.  
  146. * You cannot obtain the exit code of DOS programs run from within a script.
  147.  
  148. * The maximum length of a variable or string list item, is 255 characters.
  149.  
  150. * Internal string handling buffers are also restricted to 255 characters in
  151.   length. Complex expressions may be truncated. Where this occurs, it may
  152.   be possible to avoid the problem by breaking the operation down into
  153.   smaller steps.
  154.  
  155. * The maximum length of most command parameters is 127 characters. In
  156.   some cases, to reduce memory usage, it may be less, where a parameter
  157.   would not be expected to be very long. This should not normally be a
  158.   problem.
  159.  
  160. * Task bar icons are not supported. The Dialog Editor allows you to define
  161.   them, but they will result in an error if used.
  162.  
  163. Known problems
  164. --------------
  165.  
  166. * When clicking and dragging dialog controls in the Dialog Editor the
  167.   control may lag behind the position of the mouse. The solution is to
  168.   click on the dialog control and pause briefly before dragging or
  169.   resizing the control.
  170.  
  171. * The Add-In Tools Manager appears to hang VDS when used. The reason is
  172.   that the window has the ONTOP property set. The first time you use it,
  173.   it comes up in the center of the screen. When you click one of the
  174.   buttons the input dialog also comes up in the center of the screen but
  175.   because the main window is on top you can't see it. Attempts to click
  176.   other buttons just causes Windows to beep. If this happens, hit Esc to
  177.   cancel the input dialog. Then move the Add-In Tools Manager away from
  178.   the center of the screen. Next time you use it, it will come up at the
  179.   position you last used.
  180.  
  181. * The presence of tab characters in a script can cause problems for the
  182.   interpreter. The IDE editor does not allow tab characters to be entered.
  183.   If a different editor is used to edit scripts then care should be taken
  184.   to avoid entering tab characters.
  185.  
  186. * In the 16-bit version there is a limit on the maximum size of a script
  187.   of 32K characters. This limit is imposed by the Windows memo control
  188.   used by the editor, which (like Windows Notepad) does not allow more
  189.   than 32K of text to be loaded into it. In the 32-bit version the maximum
  190.   size of script that the editor can handle is approximately 64K
  191.   characters.
  192.  
  193. * When copying example code from the online help, blank lines appear
  194.   between some of the lines which were not present in the listing. These
  195.   blank lines can cause an error if they appear in the middle of a dialog
  196.   definition or embedded text so they should be deleted after pasting the
  197.   text into the script editor.
  198.  
  199. * If you try to create an EXE file in a directory that does not exist,
  200.   VDS will hang. In practise this can only happen if the stored path from
  201.   the last time an EXE was created from that script is no longer valid.
  202.  
  203. * The Help menu options to connect to our Web site and to register online
  204.   will only work if your system is set up to automatically associate your
  205.   Web browser with an Internet URL.
  206.  
  207. Changes in version 2.10
  208. -----------------------
  209.  
  210. New features:
  211.  
  212. * Included a Tip of the Day at start-up to inform users of tips and
  213.   featurees.
  214. * Made improvements to the editor include a user-definable tab interval
  215.   and a Smart Enter that starts a new line on the same column as the line
  216.   above.
  217. * The IDE can now optionally create integrated EXE files with the
  218.   run-time engine bound in.
  219. * (16-bit) Included a help contents browser with similar functionality to
  220.   that included with Windows 95.
  221. * Added @NUMERIC function to test whether a string is a valid number.
  222. * Added @HEX function and support for hexadecimal arithmetic (hex numbers
  223.   must be prefixed by a $ character.)
  224. * Added @ESC function to generate an Escape character (equivalent to
  225.   @CHR(27)).
  226. * Added @MSGBOX function which enables you to use the full range of
  227.   Windows message box types.
  228. * Added new window information functions @WINTEXT, @WINCLASS, @WINATPOINT.
  229. * Added WINDOW SETTEXT command to set the text of a window control.
  230. * Added WINDOW CLICK and WINDOW RCLICK commands to simulate mouse clicks on
  231.   a specified window.
  232. * Added DLGTYPE NOSYS and NOMIN to hide the system menu and minimize
  233.   button.
  234. * Added CLICK events for CHECK, COMBO, LIST and RADIO dialog elements
  235.   so an event can be triggered by making a selection.
  236. * Added EXIT events for COMBO and EDIT dialog elements so an event can be
  237.   triggered on leaving the control.
  238. * Added LIST LOADTEXT command to allow text embedded in a script to be
  239.   loaded into a string list.
  240. * Added WINHELP command to enable the Windows help system to be used by a
  241.   DialogScript program.
  242. * Added STOP command (unconditional halt, even within GOSUB).
  243. * Implemented extension interface. An additional command and function can
  244.   be added by means of a specially-written DLL.
  245.  
  246. Changes:
  247.  
  248. * Updated the Window Spy to give more information relating to the enhanced
  249.   window functions, such as the mouse position.
  250. * Programs now search their own directory as well as the current directory
  251.   for files without a full path name that are loaded from a script.
  252. * Increased the number of string lists allowed from 4 to 9.
  253. * The @CLICK function now accepts an argument of flags B, R, X, Y returning
  254.   multiple values which can be separated using PARSE. The previous format
  255.   is still accepted.
  256. * Enhanced the @WINEXISTS function to detect the existence of child
  257.   windows.
  258. * Enhanced the @SUM function so it can now sum an unlimited list of
  259.   arguments.
  260. * Fixed problem with @NEXT leaving OK unchanged rather than setting it to
  261.   True.
  262. * Fixed the problem with DIALOG CLOSE destroying the dialog before the
  263.   script finishes when run in the debugger.
  264. * Fixed the problem with trailing spaces on a command line causing
  265.   inconsistent behavior between debugger and run-time.
  266. * Fixed the problem affecting users of some European keyboards in which
  267.   characters generated by pressing the right-hand shift key were not sent
  268.   correctly by Window Send.
  269. * (16-bit) Fixed problems affecting commands and functions that access the
  270.   Registry.
  271. * (16-bit) LIST COPY and LIST PASTE now no longer restricted to a maximum
  272.   255 characters of text.
  273. * (16-bit) Fixed problem with Dialog Editor help not appearing when
  274.   running under Windows 3.1.
  275. * Fixed several problems with Icon Editor, such as Undo not working.
  276. * Fixed some bugs in the Dialog Editor.
  277. * Dialog Wizard now generates code for all events used by the dialog
  278.   without the need to manually refresh the dialog before exiting.
  279. * Improved the error checking and added additional error messages.
  280.  
  281. Changes in version 2.05
  282. -----------------------
  283.  
  284. Changes:
  285.  
  286. * (16-bit) Fixed bug affecting Alt-keys in WINDOW SEND.
  287. * Fixed bug in @NAME function (returned null if no period in filename.)
  288. * Fixed some problems with dialog editor.
  289.  
  290. Changes in version 2.04
  291. -----------------------
  292.  
  293. Changes:
  294.  
  295. * (16-bit) Fixed bug which made RUNM, RUNZ, RUNH all have the same effect
  296.   as RUN.
  297.  
  298. Changes in version 2.03
  299. -----------------------
  300.  
  301. New features:
  302.  
  303. * The OPTION PRIORITY command lets you set the priority level of your
  304.   programs.  (32-bit only)
  305. * The OPTION SKDELAYcommand lets you add a delay between characters sent
  306.   using the WINDOW SEND command.
  307. * The RUN and SHELL commands have an extra optional priority level
  308.   parameter.  (32-bit only)
  309. * In the REGISTRY command and the @REGREAD function you can now use the
  310.   STATS root key to access the Windows performance statistics under
  311.   Registry key HKEY_DYN_DATA.  (32-bit only)
  312.  
  313. Changes:
  314.  
  315. * Fixed problem with 32-bit Dialog Editor which caused incorrect wrapping
  316.   of dialog elements when inserting to the editor.
  317. * Fixed bug in Dialog Editor whereby value field clears when value of
  318.   RADIO dialog element is changed.
  319. * Fixed bug in Dialog Editor that caused default style names to always be
  320.   STYLE1.
  321. * Fixed bug in 16-bit runtime that caused first command line parameter
  322.   passed to an EXE program to be lost.
  323. * Fixed problem that caused 'Unable to run EXE' or 'Sharing violation'
  324.   messages on some systems.
  325. * Default INI file handling has been changed to use DS16.INI instead of
  326.   DEFAULT.INI for compatibility with the 16-bit version.
  327.  
  328. ===========================================================================
  329. J M Technical Services, 11a Cedar Lane, Cockermouth, Cumbria, CA13 9HN, UK.
  330.  
  331.         Find us on the World Wide Web at: http://www.jm-tech.com/
  332.